home *** CD-ROM | disk | FTP | other *** search
/ MacWorld 1998 June / Macworld (1998-06).dmg / Shareware World / Utilities / Disk & File / CDFinder 2.1 / CDFinder Read me! < prev    next >
Text File  |  1998-03-10  |  16KB  |  233 lines

  1. Dedicated to my father (1922-1997).
  2.  
  3. Welcome to CDFinder!
  4. By Norbert M. Doerner
  5.  
  6.  
  7. About CDFinder
  8. This easy-to-use and fast application creates catalog files of CD-ROMs, hard disks, floppies, ZIPs and almost everything that spins.  Using the powerful search functions you can easily locate and display files or folders.
  9.  
  10. For more information, please launch CDFinder and select "CDFinder Help" in the "Help" menu. A detailed list explaining the improvements of this new version can be found at the end of this document.
  11.  
  12. While reading this document please keep in mind that English is not my native language. Nevertheless I hope that the translation is acceptable.
  13.  
  14.  
  15. System requirements
  16. CDFinder needs System 7.0  or newer and at least a 68020-CPU or a Power-Mac. Since it also uses Color QuickDraw, it can't run on any of the older Mac Plus, SE, Classic and the PowerBook 100.
  17. I did my tests on many different Power Macs, native and using the 68k emulation.
  18. CDFinder is fully compatible to MacOS 8 and 8.1!
  19.  
  20. If drag&drop is installed, the application uses it in some parts (see below).
  21.  
  22.  
  23. Limitations
  24. The unregistered version of CDFinder will annoy you at every launch with a little dialog reminding you of the benefits of paying your shareware fee. The number of catalogs is also reduced to 25, which is surely enough to evaluate the application and its functions.
  25.  
  26.  
  27. Registration
  28. CDFinder has the following pricing:
  29. 1- 10 single user licenses, $15 per user
  30. 11-24 single user licenses, $12 per user
  31. 25-49 single user licenses, $10 per user
  32. 50+ single user licenses, $8 per user
  33.  
  34. A Site License costs $500 (roughly equal to 50 users) and covers all locations for your organization within a 160 kilometer radius of your site (100 miles). One big advantage of a Site License is that you do not need to keep track of how many people at your site are using the software. 
  35.  
  36. A World-Wide License costs $2000 and it covers all locations for your organization on the planet earth.
  37.  
  38. For additional $5 I will send you a floppy disk containing the most recent version of the program (by airmail, if possible).
  39.  
  40. Updates are free and can be obtained at the CDFinder-Homepage: http://people.frankfurt.netsurf.de/nmd/index.html
  41.  
  42.  
  43. Payment directly to the author (Cash only!)
  44. You can pay Cash by simply adding the money to your registration form. This works quite well if the envelope is made of thick paper. I do also accept cash in different currencies, please contact me! You can either use the SimpleText document enclosed with CDFinder as a registration form or use the "Registration Form" command found in the "Special" menu in CDFinder.
  45.  
  46. My postal address is:
  47.  
  48. Norbert M. Doerner
  49. Tannenstraße 2
  50. 63867 Johannesberg
  51. Germany
  52.  
  53. If you fill in your registration form without using the dialog provided by CDFinder, please print carefully. My brand new biological character recognition system (BRAIN 3.0) still needs some training ;-)
  54.  
  55. Due to very popular demand, payment is now also possible by using the great Kagi service!
  56.  
  57.  
  58. Payment via Kagi (anything else...)
  59. Just open the Register program that accompanies CDFinder. Enter your name, your email address, and the number of single user licenses you desire (or Site or Word-Wide licenses). Save or Copy or Print the data from the Register program and send the data and payment to Kagi. Kagi handles my payment processing.
  60.  
  61. If paying with Credit Card or First Virtual, you can email or fax the data to Kagi. Their email address is sales@kagi.com and their fax number is +1 510 652-6589. You can either Copy the data from Register and paste into the body of an email message or you can Save the data to a file and you can attach that file to an email message. There is no need to compress the data file, it's already pretty small. If you have a fax modem, just Print the data to the Kagi fax number. 
  62.  
  63. Payments sent via email are processed by Kagi within a week. You will receive an email acknowledgement when it is processed. Payments sent via fax take up to 20 days and if you provide a correct internet email address you will receive an email acknowledgement. If you require a written receipt, please keep in mind that even by airmail it might take a week for a letter to arrive.
  64. After you receive the acknowledgement by Kagi, I will send you the key as soon as possible. Please keep in mind that CDFinder is not my full-time job, so it could be 7 or even 12 days until you receive your key from me. Usually it will only take two or three days.
  65.  
  66. If you are paying with Cash or USD Check you should print the data using the Register application and send it to the address shown on the form, which is: 
  67.  
  68.               Kagi
  69.               1442-A Walnut Street #392-1UJ
  70.               Berkeley, California 94709-1405
  71.               USA
  72.  
  73.  
  74. You can pay with a wide variety of cash from different countries but at present if you pay via check, it must be a check drawn in US Dollars. Kagi cannot accept checks in other currencies, the conversion rate for non-USD checks is around USD 15 per check and that is just not practical.
  75.  
  76. If you have a purchasing department, you can enter all the data into the Register program and then select Invoice as your payment method. Print three copies of the form and send it to your accounts payable people. You might want to highlight the line that mentions that they must include a copy of the form with their payment.  Kagi can not invoice your company, you need to act on my behalf and generate the invoice and handle all the paperwork on your end. 
  77.  
  78. Please do not fax or email payment forms that indicate Cash, Check or Invoice as the payment method. As far as we know, there is still no technology to transfer physical objects via fax or email and without the payment, the form cannot be processed.
  79.  
  80. Payments send via postal mail take time to reach Kagi and then up to 10 days for processing. Again, if you include a correct email address, you will hear from Kagi when the form is processed.
  81.  
  82.  
  83.  
  84. Protection
  85. CDFinder has a protection scheme and when you pay, I tell you how to indicate to CDFinder that you have paid the registration fee. If you do not have an email address, please enter your complete postal address and please remember, I do not know what country you live in so please enter that into the postal address also. 
  86.  
  87. If you pay by sending me cash directly to Germany, I will send you your personal registration keyword by snail mail (airmail!) too.
  88.  
  89.  
  90.  
  91. Legal stuff
  92. CDFinder is shareware.
  93.  
  94. The application "CDFinder" and all included materials are protected by copyright law. You may not disassemble it or modify it with similar tools.
  95.  
  96. You may copy the program together with all additional documents as often as you want, as long as you don't modify any part of it! You may not sell it or use it commercially in any other way without my written consent.
  97.  
  98. If you want to distribute CDFinder on a shareware collection CD-ROM or anything like that, simply inform me with an e-mail or a written letter. I'd also like to have a copy of the CD-ROM, if possible...
  99.  
  100. For a trial period of 30 days you may freely use the program. After that, you need to register it.
  101.  
  102. In absolute no way am I responsible for any damage occurring by the use of the software. 
  103.  
  104.  
  105.  
  106. Contacting the author
  107. Just send me e-mail to
  108. Doerner@kagi.com
  109.  
  110. My postal address:
  111.  
  112. Norbert M. Doerner
  113. Tannenstrasse 2
  114. 63867 Johannesberg
  115. Germany
  116.  
  117.  
  118.  
  119. The story
  120. The whole thing started on one of those days that found me frantically searching my zillions of floppies and CD-ROMs for one particular file. Of course, I just found it on the last possible volume.
  121.  
  122. After this enlightening event I decided to search my huge software collection for a suitable cataloging tool. Most unfortunately, my search turned out empty.
  123.  
  124. Some of the tools I found required system extensions - which I do not like very much. One even created alias files of the contents of the CD-ROMs, a stupid behavior if you have some million files on several disks (the Mac OS does not like that!). Some programs were simply too slow or did puke at large CD-ROMs. Some expensive commercial applications were not native or would not run in the background. All of the tools didn't even support drag&drop!
  125.  
  126. So I made up my mind and started my own little project. Since some of my friends were quite positive about my ideas, I decided to put the results into a shareware program called "CDFinder". The application should be easy to use, very fast, support drag&drop, work in the background and include powerful search tools.
  127. And here it is!!
  128.  
  129.  
  130. System requirements
  131. CDFinder needs System 7.0  or newer and at least a 68020-CPU or a Power-Mac. Since it also uses Color QuickDraw, it can't run on any of the older Mac Plus, SE, Classic and the PowerBook 100. I did my tests on many different Power Macs, native and using the 68k emulation. If you have drag&drop installed, the application uses it in some parts (see "Help").
  132.  
  133.  
  134. Theory of operation
  135. CDFinder displays every known catalog in its main window. You can sort the content by name, size, or label. By changing the name of a catalog, you can influence the sort order for a given catalog (put a space in front of the name to let it appear right on top, if you sort by name).
  136. Using drag&drop (if installed) or "Create Catalog…", you can create a new catalog of a volume. To create lots of catalogs at once, try using "Batch Create…", which will eject any volume afterwards.
  137. To display the content of a catalog, simply double click it or select it and press "return". To obtain more information about any catalog or any object inside a catalog, simply use "Information".
  138.  
  139. But what is a bunch of catalogs without the ability to search them? Nothing! That's why you should take a very close look at the window "Find…". It will allow you to enter the type and content of information you look for, and also narrow the range by including only catalogs with a selected label to the search. You can even search just the found objects!
  140.  
  141.  
  142. Performance
  143. CDFinder is absolutely optimized for the PowerPC processor but runs very fast on the "older" Macs as well. Another positive aspect is the simple fact that you can move the program into the background during time consuming processes to work with other things.
  144. However, CDFinder must handle a real big amount of data, just go and check the size of your catalog folder! A very simple way to improve the performance is to increase the memory partition of CDFinder. Please note that increasing the file system cache using the control panel "Memory" will have no valuable effect at all, on the contrary. CDFinder is using it's own sophisticated caching mechanism that simply knows more about the state and importance of the data than the file system.
  145.  
  146.  
  147. Special things...
  148. Since CDFinder is basically designed to handle huge amounts of huge CD-ROMs and other volumes whose contents will not change at all or only very seldom, the program does not check if anything changes on a volume while the catalog is being created. This can lead to some problems if the volume is in fact changed, which is quite likely to occur for file server volumes. In that case, the content of the catalog may not be identical to the content of the volume.
  149.  
  150. Due to the nature of the current MacOS file system, CDFinder cannot catalog more than 32,000 items inside a single folder. Since you theoretically could create such folders, any items after the first 32,000 will be ignored.
  151.  
  152. It is possible to change the name of a catalog by using the "Information" window. You can also add a comment, which is displayed (the first line only) in the main window if you have selected that column in the preferences window (panel "Appearance").
  153.  
  154.  
  155.  
  156. History
  157.  
  158. The most actual version is available at the Info-Mac archives and the CDFinder-Homepage at:
  159. http://people.frankfurt.netsurf.de/nmd/index.html
  160. If you use Internet Config, you can also open the "About CDFinder…" dialog and simply click inside the http address!
  161.  
  162. 2.1 (March 12,1998)
  163. - Finally! The content of catalog windows can now be sorted and even the sort order may be changed!
  164. - It is possible to create a new catalog directly inside a catalog folder by dropping the volume icon into the folder.
  165. - The "Get Info" window for a folder inside a catalog now displays the size and number of all enclosed items.
  166. - When renaming a catalog, CDFinder now also renames the catalog file accordingly.
  167. - The user interface now not only "speaks" Italian (many thanks to Giorgio Boccalari!!!), but the French translation was also improved and extended (Thanks to Doris Wagner, Giorgio Boccalari and John Zetlaoui!!).
  168. - CDFinder now remembers if the "Find" window was open.
  169. - The "Page Setup" settings are now saved.
  170. - The drag&drop area inside the "Find" window is now larger.
  171. - Zooming of windows is much more intelligent.
  172. - System extensions and control panels are now recognized as file types.
  173. - A real lot of minor and even major bugs have been fixed!
  174.  
  175. 2.0 (December 16, 1997)
  176. - CDFinder now has a new look that might be familiar to you if you use MacOS 8.1...
  177. - The main window now displays large or small icons and the comment has an extra column.
  178. - To help you get your catatalogs organized, you can now create folders inside the main window and put catalogs into them. The display is very much like in the Finder. If you don't have drag&drop, you can also use the new submenu found in the "Special" menu to move your catalogs around.
  179. - You can now print windows!! This works for the main window, every catalog window, and the Found Objects.
  180. - Finding by name is now about 40% faster.
  181. - "Batch Create…" now recognizes that more than one volume might appear on the desktop at the same time. They are now all catalogued.
  182. - The size of large HFS+ volumes is now calculated correctly.
  183. - The "Register" dialog now intercepts "return" and "escape" keys, making input much safer...
  184. - Well, you know it, the minor bugs got addressed as well :-)
  185.  
  186.  
  187.  
  188. If you want to know more about the other older versions of CDFinder, be sure to visit the CDFinder-Homepage.
  189.  
  190.  
  191. The undiscovered country
  192. I am planning the following improvements for the next releases of CDFinder:
  193. - Selecting more than one item at once
  194. - Adjusting column widths
  195. - Folders in catalogs might be opened inside the window (just like the Finder does!)
  196. - A much improved help system.
  197. - Finding duplicates
  198. - Automatically updating catalogs
  199.  
  200. But this has yet to be discovered and everything depends on how much time I will be able to spare :-))
  201.  
  202.  
  203.  
  204. Acknowledgements
  205. First of all I would like to thank my wonderful wife Silvia. Without her patience, the development process would not have been possible.
  206.  
  207. I also want to thank all of those who helped me doing the first beta testing and thereby provided invaluable assistance checking the functions and user interface of the software: Wolfgang Warmbold, Martin Girschick, Patrick Röder, Michael Stunz, Manfred Kunkel, Ralf Schlobinski, Heiko and Manfred Richter.
  208.  
  209. Of course, without all of your registrations, I might have ceased development years ago! Thank you very much!!
  210.  
  211. The comments and notes of all registered users also helped a lot.
  212.  
  213. Please send me ideas, comments, notes and Cocoa Puffs or Star Trek books! 
  214.  
  215. Just send me e-mail:
  216.  
  217. Doerner@kagi.com
  218.  
  219. My postal address:
  220.  
  221. Norbert M. Doerner
  222. Tannenstrasse 2
  223. 63867 Johannesberg
  224. Germany
  225.  
  226.  
  227.  
  228. By Norbert M. Doerner 1998
  229. © Copyright by West-Forest-Systems 1998
  230.  
  231. Do you believe in Macintosh? Please check out 
  232. <http://www.evangelist.macaddict.com/> and join the EvangeList mailing 
  233. list by sending an email to <evangelist@macway.com>.